Jan 17, 2025
upower utility
View your battery's current state and statistics on Linux.
TLDR;
upower -i /org/freedesktop/UPower/devices/battery_BAT0
Example response
native-path: BAT0
vendor: Hewlett-Packard
model: Primary
serial: 01305 2018/02/04
power supply: yes
updated: Fri 17 Jan 2025 07:10:36 PM WAT (56 seconds ago)
has history: yes
has statistics: yes
battery
present: yes
rechargeable: yes
state: discharging
warning-level: none
energy: 33.5759 Wh
energy-empty: 0 Wh
energy-full: 35.2968 Wh
energy-full-design: 50.0115 Wh
energy-rate: 12.5223 W
voltage: 11.71 V
charge-cycles: 532
time to empty: 2.7 hours
percentage: 95%
capacity: 68.8222%
technology: lithium-ion
icon-name: 'battery-full-symbolic'
History (rate):
1737137436 12.522 discharging
The command breaks down into these parts:
upower
: The base command for power management-i
: Flag for “information”/org/freedesktop/UPower/devices/battery_BAT0
: The system path to your primary battery
When you run this command, you’ll see several key pieces of information:
Power Supply Details
- native-path: Physical location of the battery in your system
- vendor: Manufacturer of your battery
- model: Battery model number
- serial: Battery serial number
- technology: Battery type (Li-ion, Li-poly, etc.)
Current Status
- state: Current battery state (charging, discharging, fully-charged)
- percentage: Current charge level
- capacity: Health of battery compared to its original capacity
- voltage: Current voltage level
- time to empty/full: Estimated time until battery depletes/charges
Historical Data
- energy-rate: Current power consumption rate
- energy: Current energy level
- energy-full: Maximum energy when fully charged
- energy-full-design: Factory-designed maximum energy
If BAT0
doesn’t work, your battery might be at:
battery_BAT1
battery_CMB0
battery_BAT
You can list all power devices with:
upower --enumerate